home *** CD-ROM | disk | FTP | other *** search
/ Network Supervisor's Toolkit / Network Supervisor's Toolkit.iso / lantastc / lancheck / lancheck.doc next >
Text File  |  1996-07-10  |  15KB  |  307 lines
  1.              LANtastic (tm) LANCHECK Program Documentation
  2.                ------------------------------------------
  3.                    (C) Copyright 1990 ARTISOFT Inc.
  4.  
  5.  
  6. Once the NETBIOS has been installed, you can be sure that
  7. the adapter is functioning.  You cannot, however, be assured
  8. that the adapter can communicate with the network.
  9.  
  10. There may be several reasons why an adapter is not
  11. communicating with the rest of the network.  The most
  12. obvious cause is that the cabling is faulty or not connected
  13. correctly.  Another reason may be that there has been a
  14. hardware failure on the adapter in the circuitry that is
  15. responsible for communication on the network.
  16.  
  17. The distribution floppy disk that comes with your LANtastic
  18. Starter Kit contains a LAN diagnostic program (LANCHECK)
  19. which may be used to make sure that all adapter cards are
  20. functioning and connected together on the network.  The
  21. LANCHECK program appears as LANCHECK.EXE on the distribution
  22. diskette.
  23.  
  24. To run the program type:
  25.  
  26.      LANCHECK a-unique-name  [/MONO]
  27.  
  28. where a-unique-name is a unique name (up to 16 characters)
  29. that you wish your PC to be known by on the network.  This
  30. name will be displayed on each computer running LANCHECK and
  31. allows you to monitor which computers are actively running
  32. LANCHECK.
  33.  
  34. It is recommended that you bring up all your network nodes
  35. simultaneously to ensure that they are evaluated for
  36. performance during the same period.   LANCHECK evaluates
  37. each node's performance from when it is first brought up on
  38. the network, not just from the time LANCHECK is executed.
  39. LANCHECK will test six adapter cards per computer (adapters
  40. 0 through 5) and can display a maximum of 1000 nodes.  You
  41. can run LANCHECK any time after bringing up the NETBIOS, even
  42. after other LAN software is running.
  43.  
  44. The most important test for the adapters is whether they all
  45. appear on the screen when LANCHECK is run.  If an adapter is
  46. not listed on the LANCHECK screen, it is probably not
  47. communicating with the rest of the network.
  48.  
  49. The optional switch /MONO forces the screen to run
  50. the LANCHECK program in monochrome (2 color) mode.
  51.  
  52. Testing a Network Adapter
  53.  
  54. After the NETBIOS software has been installed, type the
  55. following commands:
  56.  
  57.      LANCHECK a-unique-name
  58.  
  59. For example,
  60.  
  61.      LANCHECK JOAN
  62.  
  63.           or
  64.  
  65.      LANCHECK BOB
  66.  
  67. would be typical unique names.
  68.  
  69. After an initialization message and a short pause (Note: the
  70. pause will be longer if you have multiple adapter cards
  71. attached),  the LANCHECK screen will appear as shown:
  72.  
  73. LANtastic (tm) LANCHECK  Version 3.01  (C) Copyright 1990 Artisoft Inc.         
  74.  
  75. ╔═══════════════════════════════════════════════════════════════════════════╗  
  76. ║ A#  NAME             NODE NUMBER   MINUTES RUNNING   STATUS   ERROR INDEX ║  
  77. ╠═══════════════════════════════════════════════════════════════════════════╣  
  78. ║ 0   BOB              00006EA00029        9           (local)     2%       ║  
  79. ║ 0   JOAN             00006EA00045        9           active      2%       ║  
  80. ║                                                                           ║  
  81. ║                                                                           ║  
  82. ║                                                                           ║  
  83. ║                                                                           ║  
  84. ║                                                                           ║  
  85. ║                                                                           ║  
  86. ║                                                                           ║  
  87. ║                                                                           ║  
  88. ║                                                                           ║  
  89. ║                                                                           ║  
  90. ║                                                                           ║  
  91. ║                                                                           ║  
  92. ║                                                                           ║  
  93. ║                                                                           ║  
  94. ║                                                                           ║  
  95. ║                                                                           ║  
  96. ╚═══════════════════════════════════════════════════════════════════════════╝  
  97.                                                                                 
  98. Enter - Select Entry,  Esc - Exit Lancheck,  Space - Update Screen,  F1 - Help  
  99.  
  100. At any time while the LANCHECK program is running you may
  101. press the F1 key to receive more information about the
  102. fields presented in the screen.  You can make the help
  103. window double in size by pressing the letter Z on the
  104. keyboard.  Pressing Z a second time will change the help
  105. screen back to its original size. Use the arrow keys to
  106. scroll the text up and down, or use the PgUp or PgDn  keys
  107. to move the text up or down a page.
  108.  
  109. The screen updates itself every ten seconds, or when you
  110. press the SPACE BAR.
  111.  
  112. "A#" tells you which adapter you are receiving information
  113. on .  The first adapter is numbered "0," the second "1" and
  114. so on.  Up to six adapters per computer may be tested.
  115.  
  116.  "NAME" refers to  the unique node name you specified with
  117. the LANCHECK command.   Check to make sure that all the
  118. adapter cards you are running LANCHECK on are listed in this
  119. table.  If any are missing, you may have a cabling problem
  120. or a faulty adapter.
  121.  
  122. "NODE NUMBER" denotes the unique network number assigned to
  123. the adapter. "Minutes Running"  shows how long the adapter
  124. has been running since you installed the NETBIOS software.  The
  125. "Status"  field tells you whether the adapter being tested
  126. is active or inactive, and which adapters are "local,"
  127. (located on your computer).  If an adapter that is supposed
  128. to be active lists as inactive, there may be a problem with
  129. the adapter or the cabling to that adapter.  If you see an
  130. adapter with a status that keeps switching between "Active"
  131. and "Inactive"  there is probably an intermittent problem
  132. with the cabling.
  133.  
  134. The Field "ERROR INDEX"  presents you with a statistic to
  135. help you deduce the relative performance of each adapter in
  136. the sending and receiving of network data.  The values given
  137. in the example above should not be considered an average or
  138. ideal value for the adapters you are evaluating.  Look
  139. instead for adapters that have ERROR INDEX  values that are
  140. either much higher or lower than the other adapters in your
  141. network.  An adapter with a much higher ERROR INDEX  might have a
  142. cabling problem or other hardware problem.  Low values might
  143. indicate the node is able to receive data correctly, but is
  144. not properly transmitting data to the rest of the network.
  145. This will increase the other nodes' ERROR INDEX  scores
  146. because they will be receiving bad transmissions from the
  147. faulty adapter.
  148.  
  149. To further evaluate the efficiency of a network node, use
  150. the arrow keys to move the highlight bar to the desired node
  151. and press ENTER. This window will appear:
  152.  
  153.  
  154. LANtastic (tm) LANCHECK  Version 3.01  (C) Copyright 1990 Artisoft Inc.         
  155.  
  156. ╔═══════════════════════════════════════════════════════════════════════════╗  
  157. ║ A#  ╔══════════════════════════════════════════════════════════════╗ INDEX║  
  158. ╠═════║               Adapter Status of: JOAN                        ║══════╣  
  159. ║ 0   ╠══════════════════════════════════════════════════════════════╣      ║  
  160. ║ 0   ║                  Adapter Number: 0                           ║      ║  
  161. ║     ║                     Node Number: 00006EA00045                ║      ║  
  162. ║     ║                Software Version: 2.10                        ║      ║  
  163. ║     ║════════════════════════════════╤═════════════════════════════║      ║
  164. ║     ║  TRAFFIC AND ERROR STATISTICS  │ ADAPTER RESOURCE STATISTICS ║      ║    
  165. ║     ║────────────────────────────────┼─────────────────────────────║      ║
  166. ║     ║    Minutes Running: 9          │     NCBs Available: 26      ║      ║  
  167. ║     ║         CRC Errors: 222        │     NCBs Allocated: 32      ║      ║  
  168. ║     ║   Alignment Errors: 320        │  Max NCBs Possible: 128     ║      ║  
  169. ║     ║         Collisions: 9          │    Active Sessions: 4       ║      ║  
  170. ║     ║  Bad Transmissions: 65         │ Sessions Allocated: 32      ║      ║  
  171. ║     ║ Good Transmissions: 3928       │  Sessions Possible: 128     ║      ║  
  172. ║     ║      Good Receives: 23103      │    Max Packet Size: 2461    ║      ║  
  173. ║     ║    Retransmissions: 65         │    Number of Names: 8       ║      ║  
  174. ║     ║   Resource Exhaust: 838        │                             ║      ║  
  175. ║     ╚══════════════════════════════════════════════════════════════╝      ║
  176. ║                                          ║                                                                           ║  
  177. ╚═══════════════════════════════════════════════════════════════════════════╝  
  178.                                                                                 
  179. Esc - Exit Status Window,  Space - Update Data, F1 - Help                       
  180.  
  181. The information at the top of the window tells you the name
  182. of the node, adapter number and node number being tested as
  183. well as the version of the LANCHECK  software you are using.
  184. The bottom left portion of the screen provides you with
  185. "Traffic and Error Statistics"  which may help you diagnose
  186. a hardware problem with you network.  To the right of this
  187. are the "Adapter Resource Statistics"  which provide
  188. information concerning your NETBIOS configuration.
  189.  
  190. Once again, do not assume that the values presented in the
  191. example above are the same values that you should see.  What
  192. you should look for instead are values that are out of the
  193. average range for the rest of your adapters.
  194.  
  195. Traffic and Error Statistics
  196.  
  197. The field "Minutes Running"  refers to the length of time
  198. since the NETBIOS was run.
  199.  
  200. Cyclical Redundancy Check (CRC) errors occur when a packet
  201. of data arrives at a node in a corrupt form.  Before a
  202. computer sends a packet,  it mathematically evaluates the
  203. contents of the packet and places this information in it.
  204. The receiving node performs the same calculation on the data
  205. as it receives it then matches it against the results of the
  206. sending node's evaluation.  If the results don't match, the
  207. receiving node asks the sending node to retransmit the
  208. packet.
  209.  
  210. A high value in the "CRC" field could indicate that an
  211. adapter is not correctly transmitting data.  It might also
  212. indicate faulty cabling or electrical noise is corrupting
  213. the data in transit.
  214.  
  215. Alignment errors occur when bits of data arrive out of the
  216. 8-bit group they were sent in.  These bits must then be
  217. regrouped into their original bytes by the receiving node.
  218. While this does not usually degrade network performance,  a
  219. high value in this field could indicate cabling or hardware
  220. problems.
  221.  
  222. Network collisions occur when two or more nodes attempt to
  223. access the network simultaneously.  A high value here will
  224. usually indicate a busy network.  In rare cases, however, a
  225. malfunctioning adapter will continuously transmit noise
  226. resulting a higher number of collisions.
  227.  
  228. The fields, "Good Transmissions"  and "Bad Transmissions"
  229. provide you with statistics for successful and unsuccessful
  230. transmissions.  Busier networks will have more unsuccessful
  231. transmissions than networks with less frequent use.  A high
  232. number of Bad transmissions could indicate a faulty adapter.
  233. "Retransmissions"  occur after unsuccessful transmissions.
  234. Once again,  look for values that are significantly higher
  235. than the rest of the nodes.
  236.  
  237. A low value for "Good Receives" could indicate that an
  238. adapter is not receiving network data well.  In such cases,
  239. it is best to test this node with only a few other adapters
  240. and make sure this low value is not a result of poor
  241. transmissions from an adjoining network node.
  242.  
  243. When a node exhausts its supply of buffers, it can no longer
  244. receive data from the network.  The field "Resource Exhaust"
  245. keeps count of each time this happens.  If your node is
  246. continually running out of buffers, it may be advisable to
  247. set your buffers higher to better  accommodate your network
  248. traffic.
  249.  
  250. If you suspect that there is a hardware problem and an
  251. adapter has a higher than average value in one or more of
  252. the above categories, remove the node from the network and
  253. see how network performance changes.  If performance goes up
  254. dramatically the adapter could be at fault.
  255.  
  256. Adapter Resource Statistics
  257.  
  258. The values  given in  this field  can help  you evaluate how
  259. well your  software configuration  meets your network needs.
  260. For example, if you don't have enough Network Control Blocks
  261. (NCBs), to  process data  and commands  in and  out  of  the
  262. adapter, network  performance will  suffer, or  some network
  263. software will not run.
  264.  
  265. If the field "NCBs Available"  has a value less than eight
  266. you should consider raising the number of NCBs allowed for
  267. this adapter.  You can set this with the NETBIOS command
  268. line switches.  A good way to estimate the number of NCBs you
  269. need is to take the number of log ins you will need and add
  270. eight.  
  271.  
  272. The "Max NCBs Allocated" field informs you how many are
  273. allocated in the NETBIOS command line.  The maximum
  274. number of NCBs available depends on the NETBIOS.
  275.  
  276. A session is created any time a connection between two nodes
  277. is made or attempted to be made.  If the number given in the
  278. "Active Sessions"  seems out of proportion with what you
  279. feel it should be, check your software to make sure it is
  280. configured for the proper number of sessions.  The maximum 
  281. number of sessions available depends on the NETBIOS.
  282.  
  283. "Max Packet Size"   refers to the largest size data packet
  284. that this adapter can either send or receive.   The Maximum
  285. size of a data packet depends on the size of the buffers set
  286. for the adapter.
  287.  
  288. The field "Number of Names"  refers to the number of network
  289. names currently being used.  An adapter with a much larger
  290. value than the other adapters may be running a program that
  291. is erroneously creating a large number of names.
  292.  
  293. To check a second node, press Esc to exit to the previous
  294. window then select the node you want to test and press
  295. ENTER.
  296.  
  297. You can also check the adapter status of any network node by
  298. pressing Ins while in the first LANCHECK window.  A screen
  299. will appear asking you for the name of the node you want to
  300. test.  Type in the name exactly as it used by the node in
  301. question, then press ENTER.  Normally you will use all
  302. capital letters. The "Adapter Status"   window for the
  303. desired node will appear.  Repeat this process for each
  304. adapter you want to evaluate.  To exit the LANCHECK program
  305. from the main window, press the  Esc key.
  306. 
  307.